home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / graphic / pbmpl91d.zip / PBMPLUS / MAN / PPMTOSIX.MAN < prev    next >
Text File  |  1993-01-08  |  2KB  |  67 lines
  1.  
  2.  
  3. ppmtosixel(1)              Unix Programmer's Manual              ppmtosixel(1)
  4.  
  5.  
  6. NAME
  7.      ppmtosixel - convert a portable pixmap into DEC sixel format
  8.  
  9. SYNOPSIS
  10.      ppmtosixel [-raw] [-margin] [ppmfile]
  11.                                   -------
  12.  
  13. DESCRIPTION
  14.      Reads a portable pixmap as  input.   Produces  sixel  commands  (SIX)  as
  15.      output.  The output is formatted for color printing, e.g. for a DEC LJ250
  16.      color inkjet printer.
  17.  
  18.      If RGB values from the PPM file do not have maxval=100,  the  RGB  values
  19.      are  rescaled.   A  printer  control  header and a color assignment table
  20.      begin the SIX file.  Image data is written  in  a  compressed  format  by
  21.      default.  A printer control footer ends the image file.
  22.  
  23. OPTIONS
  24.  
  25.      -raw If specified, each pixel will be explicitly described in  the  image
  26.           file.   If  -raw is not specified, output will default to compressed
  27.           format in which identical adjacent pixels are  replaced  by  "repeat
  28.           pixel"  commands.   A raw file is often an order of magnitude larger
  29.           than a compressed file and prints much slower.
  30.  
  31.      -margin
  32.           If -margin is not specified, the image will be  start  at  the  left
  33.           margin   (of  the  window,  paper,  or  whatever).   If  -margin  is
  34.           specified, a 1.5 inch left margin will offset the image.
  35.  
  36. PRINTING
  37.      Generally, sixel files must reach the printer unfiltered.  Use the lpr -x
  38.      option or cat filename > /dev/tty0?.
  39.  
  40. BUGS
  41.      Upon rescaling, truncation of the least significant bits  of  RGB  values
  42.      may  result  in  poor  color  conversion.  If the original PPM maxval was
  43.      greater than 100, rescaling also reduces  the  image  depth.   While  the
  44.      actual  RGB values from the ppm file are more or less retained, the color
  45.      palette of the LJ250 may not match the colors on your screen.  This seems
  46.      to be a printer limitation.
  47.  
  48. SEE ALSO
  49.      ppm(5)
  50.  
  51. AUTHOR
  52.      Copyright (C) 1991 by Rick Vinci.
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.                                 26 April 1991                                1
  66.  
  67.